Ny, 


Cassette: 24K (APX-10117) Diskétte: 32K (APX-20117) 


ad 


@ ATARI? PROGRAM EXCHANGE 


Paul G. Abell 


PLAYER GENERATOR 


Create players, with storage and print features 


a User-Written Software for ATARI Home Computers 


Paul G. Abell 


_ PLAYER GENERATOR 


Create players, with storage and print features 


Cassette: 24K (APX-10117) Diskette: 32K (APX-20117) 


rFLAYErF GENERATOR 
by 


Faul G. Abell 


Frogram and Manual Contents © 19982 Paul G. Abell 


Copyright notice, On receipt of this computer program and associated documentation (the 
software), the author grants you a nonexclusive license to execute the enclosed software, This 
software is copyrighted. You are prohibited from reproducing, translating, or distributing 

this software in any unauthorized manner, 


Distributed By 


The ATARI Program Exchange 
P.O. Box 3705 
Santa Clara. CA 95055 


To request an APX Product Catalog, write to the address above. or call toll-free: 


800/538-1862 (outside California) 
800/672-1850 (within California) 


-Or call our Sales number, 408/727-5603 


Trademarks of Atari 
The foilowing are trademarks of Atari, Inc. 


ATARI® 

ATARI 400™ Home Computer 
ATARI 800™ Home Computer 
ATARI 410™ Program Recorder 
ATARI 810™ Disk Drive 

ATARI 820™ 40-Column Printer 
ATARI 822™ Thermai Printer 
ATARI! 825™ 80-Column Printer 
ATARI 830™ Acoustic Modem 
ATARI 850™ Interface Module 


Printed in U.S.A. 


TABLE OF 


Introduectiarc+seev eevee 
QVOEPVLOWe sr eeereeeenar 


Required eccessories., 


SCCeGSSsaOrTLlesss 


Optionelt 


Contacting the gsuthor 


*. 


Getting 
Joystick Controller 
Creating 2 
Veing PLAYER 


Commend explanations: 
Desian Sereerre «+ e+e eee 


Command explanations! 
Move 


ee ” 7 
OCT GG ere eee eeeees 


Commend explanations! 
Command Sere@eermesescees 


Frocram festuressereas 


Filename defanultssececes 


a ot fe wy ped 
startadsesrceces 


PLBYvEersesees 


GENERATOR » 


+ 


CONTENTS 


$e reo e eo oe PSs 


2 


tee ee ee eo PQ 


peeve ee oe PG 


+ 


te eee cee Pe 


+ 


MOVE@MEMNLS «sf Qe 


tte ee ea PS 


* 


tee ee ee PQ 


> 


eee eee Pe 


tee reo ae Pe 


terre e ee he 


pees eoe el Qe 


Limitations and WEPMLMQS+ +e eee se P Qe 


HAMELS se cee eee rere eee eee eee eons ae eps 


ADGUL YOUT MGW PrOGrateceeeeee +P Qe 


QUICK REFERENCE SHEET: 


COMMEMGE eet eee ener ee ee eee eee ee Pe 


INTRODUCTION 


OVERVIEW 


layer-missle Graphics is a relatively new world to the average ATARI Home Computer user, 
This program will attempt to assist the novice programmer in becoming familiar with 
Player Missile Graphics. Any design can be created, within resolution limits, using 
this program, The user will be able to create a design, save it, or load a previously 
saved design. Once a design is finalized, it can be used to create aprogram. This 
Program can then be used as the basis of a game, educational program, or business program. 


REQUIRED ACCESSORIES 


ATARI BASIC Language Cartridge 
One Joystick Controller 


Cassette version 


24K RAM 
ATARI 410 Program Recorder 


Diskette version 


32K RAM 
ATARI 310 Disk Drive 


CPTIONAL ACCESSORIES 


ATARI Printer or equivalent printer 


CONTACTING THE AUTHOR 


Users wishing to contact the author about PLAYER GENERATOR may write or call him att 


2032 St. Christopher Drive 
Lesingtonms Kerrbueky 40502 


(406) 233-3537 


wads 


GETTING STARTED 


LOADING PLAYER GENERATOR INTO COMPUTER MEMORY 
i. Insert the ATARI BASIC Lanquage Cartridge in the cartridge slot of your computer. 
2. Plug your Joystick Controller into the first controller jack of your computer console, 
3. If you have the cassette version of PLAYER GENERATOR? 
a. Connect your program recorder to the computer and to a wall outlet, 
b. Turn on your computer and your TV set. 


c. Slide the PLAYER GENERATOR cassette into the program recorder’s cassette holder 
and press REWIND on the recorder until the tape rewinds completely. Then press PLAY, 


d. Type CLOAD on your computer and then press the RETURN key two times. The tape 
will load into computer memory. 


e. After the tape finishes loading, the word READY will display on your TV screen. 


Type RUN and press the RETURN key. The program’s first display screen will appear on 
your TV screen. 


If you have the diskette version of PLAYER GENERATOR? 
a, Have your computer turned OFF, 
b. Turn on your disk drive, 
c. When the BUSY light qoes out, open the disk drive door and insert the PLAYER 
GENERATOR diskette with the label in the lower right-hand corner nearest to you. 


(Use disk drive one if you have more than one drive.) 


d. Turn on your computer and your TV set. The program will load into computer memory 
and start automatically, 


THE FIRST DISPLAY SCREEN 


Once the program loads into computer memory, large letters will appear on the screen, 
with a small text window at the bottom. The large letters will say, "PLAYER GENERATOR", 
The text window will say, "Press any key ato begin”. Press any key and the screen will 
become blank. An initializtion message appears while the program sets up the design 


screen, 


THE DESIGN GRID 


A design arid, eiqht dots wide and twenty two lines long appears. The upper left hand 
dot will flash, indicating your present position on the grid. Press the red button on 


the Joystick, to turn this dot into a flashing square. Press it again and the dot will 
return. 


JOYSTICK MOVEMENTS 


Use the Joystick to position the flashing dot on the qrid. Make sure that you’re holding 
the Joystick with the red button at the upper left corner and the word, TOP, facing the 
t.v. screen. Push the Joystick up to make the dot move up, Pull back to move the dot 
down. Push right and left to make the dot move to either side. Diagonal movements will 
cause the dot to move diagonally. 


CREATING THE PLAYER 


As you create the player, it is drawn simultaneously alongside the grid. When the design 
has been finalized, press (M) for player movement. The screen will clear and anew set 
of commands will appear along with the player. The player can now be moved on the screen 
with the joystick. During the move phase, two commands will appear at the bottom of the 
screen. (B) will return to the design screen. (C) will cause the screen to ao blank, 

turn off the player and list out anew set of commands, See the command section for an 
explanation of each command. To create a program using the newly created design, press 
(L) while on the command screen, the screen will clear and if a disk is connected, the 
disk directory will appear. Using the DOS filename convention, type in a file name, 
(EXAMPLE! DiSTAR.PM) If no diskette is attached, then the program will use the 
cassette. No file name will be asked for. Load a program, diskette or cassette and 
press any key. If the cassette is being used, two beeps will be heard from the speaker, 
indicating the user should press play and record on the cassette player, After the two 
beeps, press RETURN on the keyboard and the proqram will be saved to cassette. If the 
diskette is attached, then the proqram will be saved to diskette, 


USING FLAYER GENERATOR 


INTRODUCTION 
This program allows the user to create a design on a grid of dots, The dots serve to 
outline the area that can be used for the design. The three basic screens used in the 
program are} 


1, Design screen 
2, Move screen 
3. Command screen 


The user will move from one screen to the next and back. It isn’t necessary to ga 
through each screen every time you run the program. Some screens may be skipped in 
order ta load an old design for modification, or to print out player data for a 

particular design. Once the design is finalized, a program may be created, using this new 
design, or the user may simply exit without creating a program. 


The program is a collection of subroutines, One of the subroutines, the Joystick 
vertical direction, was used with permission from COMPUTE! MAGAZINE, P.O, BOX 04, 
GREENSBORO NC. 27403, This subroutine is used in the interest of equalizing speed, 
horizontally and vertically. 


COMMAND EXPLANATIONS: BESIGN SCREEN 


(Bdackground 0 

This command will change the background color of the screen, not the color of the player. 
The full range of colors available in ATARI BASIC can be selected (0, 1, 2, s.) 15). 

No provision has been made to alter the luminance of the background, To cycle through the 
colors; press C repeatedly. 

(Ciolor é 

This command will change the color of the player. The full range of color available in 
ATARI BASIC can be selected (0, 1, 2, w+, 15), To cycle through the colors, press C 
repeatedly, 


(Erase 


This command must be used carefully, as it will erase the design on the grid and the 
player. You can then start over with a clean grid, 


(Tonverse 


This command will exchange the dots and color squares on the design grid, Press I again 
to return to the original dot-square pattern, 


{(Liuminance Z 
This command will alter the luminance of the player. The full range of luminance 


available in ATARI BASIC can be selected (0, 2, 4, d+ «+ 14). To cycle through the 
luminances, press L repeatedly. 


(Move 


This command transfers the user ta the Move Screen, allowing the user to move the design 
in any direction on the screen with the Joystick. 


(Random 


This command will generate a random pattern on the design grid, erasing whatever was 
previously on the grid. 


(Size #i 


This command will alter the size of the player as it is displayed, The range is from #1 
{times one, normal), to *Z (twice normal), and #4 (quadruple), 


COMMAND EXPLANATIONS! MOVE SCREEN 


Use the commands on this screen to move your player around. 


(Black to design screen 


This command will return the user to the design screen, 


(C)ammand screen 


This command will transfer the user to the command screen, 


COMMAND EXPLANATION! COMMAND SCREEN 


(Back to design screen 


This command will return the user to the design screen. 


(Ejnd 


This command will end the program and return you to the READY prompt. 


{Lhist program 


This command will create a demonstration program using the design just created. When you 

use this command, the DOS directory displays along with the prompt, NAME?, To run the 
demonstration type NEW and press RETURN. Then type ENTER Difilename and press RETURN, 
Finally, type RUN and press RETURN (see filename defaults), 


(Pyrint 
This command displays player data, consisting of! 


1. Player color (e.g., COLOR = 9) 

2. Player luminance (e.g,, LUMINANCE = 4) 

@, Player size (e.g. SIZE = #2) 

4, Player byte data values (e.g.,, PLAYER DATA = 179, 204, 212, 19, 54, 148, 13, 148) 
s+ Background color (e.g,, BACKGROUND = 4) 


(Retrieve design 


This command will load a design from diskette or cassette, If a diskette is being used, 
the disk directory will be displayed and a filename asked for. If the file cannot be 

found, an error message will be displayed and the program will list out the directory 

again. See Filename Defavits. If you press RETURN in response to the NAME? prompt, the 
program returns you to the Command Screen, 


(Save design 


This command will save a design to diskette or cassette, If a diskette is being used, 

the disk directory will display first. If the design cannot be saved, an error message 

will be displayed and the program will list out the directory again. See Filename 

Defaults. Press RETURN in response to the NAME? prompt and you’ll return to the Command 
Screen, 


EXAMPLE OF ENTER COMMANDS 


ENTER "Ci" 
ENTER "DISTAR.PM" 
Then type RUN 


The computer will load the program for your already created player which you can now move 
around the screen. 


When the option (L) is chosen, the ENTER comand must be used to load the newly created 
program after it has been saved, Type NEW before using the ENTER command. Failure to 
type NEW before using ENTER will cause major problems and will result in the new program 
nat working. 


PROGRAM FEATURES 


When using filenames with the diskette, you can choose to use filename extenders or not. 
If they’re not used, the program will default to an extender name of ".SHP" for shape 
filenames and ".LST" for list pragram filenames, 


4 feature of the design screen is the printing of associated parameters next to the 
commands, The background color number is printed next to its command, and so on. The 
Same applies for each command that has a variable, 


The program will default to cassette operation if a disk drive is not connected or 
available, 


If a printer is not connected, the program will default to the screen when printing 
player data, 


The "screen attract" mode is disabled by the program. 
The ATARI logo key is reset automatically if depressed, 
The player is drawn as the design grid is changed, 


There are four shape designs included with this program on diskette. They are included 
to give the user some idea of how the program works and what can be generated, Simply, 
run the program, type "M", "C", and then "R". Type in the name of one of the designs 
listed below and press RETURN. 


1. AST1.SHF 
@- AST2.SHF 
3. AST. SHF 
4, AST4.SHF 


The feature of "one key entry" is used throughout the pragram. The exceptions are} 


1. After entering a filename whenever loading or 
saving to cisk. 

2+. When saving of loading @ desien to cassette, 
3S. When creating a list program. 

(filename asked for with disk) 


In the above named instances "RETURN" must be pressed, when appropriate, 


FILENAME DEFAULTS 


The user is prompted for a filename whenever loading or saving a design to diskette. The 
DOS filename convention should be used, but is not necessary. The filename will default 
to an extender of "SHP" for designs and "LST" for listing programs, plus the device 
location will be appended to the beginning of the file name. Thus, if you type "ROBOT" 
was typed for the filename, the program will save the design under the name of 
"DIROBOT.SHP". This default will work on both loading and saving from diskette, 


EXAMPLES: 

OR TOE INAL DEF AULT 
uger bLypes COMpuUter wses 
ROBOT DIROROT. SHE 
ROBOT. SHE DF ROBOT. SHF 
DO? ROBOT DSROROT. SHE 
DS ROBOT. SHE DS ROBOT. SHF 
ROBOT. FM DIROBOT. FM 


When saving or loading, if RETURN is pressed in response to the prompt, NAME ?, the user 
will be returned to the Command Screen, 


~10- 


LINITATIONS 
AND 
WARNINGS 


Player Missile Graphics will allow up to five individual players. This program will 
create one player design at atime. It is possible to position all five players next to 


each other creating one player. This program is not set up to generate multiple players 
or missiles, 


Type NEW before using the ENTER command. If this is not observed, the new program will 
be merged with the existing PLAYER GENERATOR program! This will result in neither 
program working ! 


The demonstration program can be CSAVED to cassette, or SAVED to diskette, immediately 
after loading. This has the advantage of faster loading the next time the program is 
loaded. 


If, while in the Design Screen, the cursor (flashing dot or square) is at the bottom of 
the grid and (I) is pressed, the grid will scroll upward. This will not affect the 


Player, but will make it hard to use the design grid. To correct this, type (M) and 
then (B), 


The BREAK and RESET keys are not disabled and will work if accidentally pressed. If 
BREAK is pressed, all is not lost. Type CONT and go on to another screen. This will 
reset same parameters and usually return the user to the prior condition. If RESET is 
pressed, the program will stop and the user will be returned to the system (BASIC), 


Lower case will cause a "create error" when trying to save a design and a "file not 


found" error when trying to laad a design. It will not cause a problem with the other 
commands, 


This program uses 11,176 bytes of memory. It takes approximately 3 min, 54 sec. to load 
from cassette. It takes 14 seconds to load from disk, 
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HINTS 


A register called PRIOR (POKE 622,X) controls the priority of the players and the 
Playfield. You can make a player disappear behind another player or any object on the 
screen, This can lead to some interesting effects. Poke this register with! 


Priorities are} 


PFO, FFL, PO-P3, PF2-3, BACKGROUND 8 


FFO-3, FO-3, BACKGROUND 4 
FO—1, PFOQ-3, P2Z-3, BACKGROUND z 
PQ-3, FFO-3, BACKGROUND 1 


eX. FORE 622, 


FFO = playfield zero 
FO = player zero 


The playfield is the center screen only. The background is the border around the 
Playfield. If the playfield is given priority, the player will not be visible until it 
appears on the border of the screen. 


The player can be made to disappear by simply resetting its color to the background color, 
ABOUT YOUR NEW (CLodist PROGRAM 


The demonstration program created by PLAYER GENERATOR, can be made to run a little 
smoother and faster. To do this, reset the variable "H" to the number of non-zero data 
bytes used by the player missile design. You must also eliminate the zero bytes out of 
the data statement. This works because of the machine lanquage move routine. It has to 
move these bytes in the vertical direction and the fewer bytes it has to move the faster 
it can do it, 


This created program was designed to be used as a demonstration program, It can alsobe 
used as the basis of any new program. Use a good renumbering program, such as those 
offered in the APX catalog, to renumber the program after inserting any new code, 


The range of movement of the player has been limited in the program to prevent errors and 
Program crashing. The move routines will move a lot faster if these "CHECKS" are 
removed, The "X" range is from 1 to 255, 

The "Y" range doesn’t have a "RANGE" as such, but will cause problems if it gets too far 
off screen. The player is moved vertically through memory and when it gets aut of the 
Player missile display memory it can cause the system to crash ! 


COMMANDS — QUICK FEFERENCE SHEET 


Design Screen ? 


(Bdeckground Calter backeround color) 


(Cdolor Calter color of player) 
(Edrase (erase player and desian arid 
(li nverse (reverse color and dots? 
C(Louminanice Calter luminance of player) 
(Move (proceed to move sereen) 
(Roandam (generate @ random pattern) 
(Size Calter size of player) 

Move screem ? 

(CB) eel. (return to desian screen) 
(Coommanc 

SCT eer (proceed to command screen) 


Command screen } 


(Bdeck, (return to design screen) 

CE dred Cend program prematurely) 

(Loast (list demo proarsam to output device) 
(Porint (print player data? 

(Retrieve (retrieve design from diskette) 
(Save (save desian to diskette) 
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Limited Warranty on Media and Hardware Accessories. We, Atari, Inc., guarantee to you, the original 
retail purchaser, that the medium on which the APX program is recorded and any hardware 
accessories solid by APX are free from defects forthirty days from the date of purchase. Any applicable 
implied warranties, including warranties of merchantability and fitness for a particular purpose, are 
also limited to thirty days from the date of purchase. Some states don't allow limitations on a warranty’'s 
period, so this limitation might not apply to you. If you discover such a defect within the thirty-day 
period, call APX for a Return Authorization Number, and then return the product along with proof of 
purchase date to APX. We will repair or replace the product at our option. 


You void this warranty if the APX product: (1) has been misused or shows signs of excessive wear, 
(2) has been damaged by use with non-ATARI Home Computer products; or (3) has been serviced or 
modified by anyone other than an Authorized ATARI Computer Service Center. Incidental and conse- 
quential damages are not covered by this warranty or by any implied warranty. Some states don’t allow 
exclusion of incidental or consequential damages, so this exclusion might not apply to you. 


Disclaimer of Warranty and Liability on Computer Programs. Most APX programs have been written 
by peopie not employed by Atari, Inc. The programs we select for APX offer something of value that we 
want to make availabie to ATARI Home Computer owners. To offer these programs to the widest 
number of peopie economically, we don’t put APX products through rigorous testing. Therefore, APX 
products are sold “as is,” and we do not guarantee them in any way. In particular, we make no warranty, 
express or implied, including warranties of merchantability and fitness for a particular purpose. We are 
not liable for any losses or damages of any kind that result from use of an APX product. 


For the complete list of current 
APX programs, ask your ATARI retailer 
for the APX Product Catalog 


\ Y faeuk 
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We're interested in your experiences with APX programs 
and documentation. both favorable and unfavorabie. 
Many of our authors are eager to improve their programs 
if they know what you want. And. of course. we want to 
know about any bugs that slipped by us. so that the 
author can fix them. We also want to know whether our 


1. Name and APX number of program. 


Review Form 


instructions are meeting your needs. You are our best 
source for suggesting improvements! Please heip us by 
taking a moment to fill in this review sheet. Foid the sheet 
in thirds and seal it so that the address on the bottom of 
the back becomes the envelope front. Thank you for 
helping us! 


2. If you have problems using the program, please describe them here. 


3. What do you especially like about this program? 


4. What do you think the program's weaknesses are? 


5. How can the catalog description be more accurate or comprehensive? 


6. Onascaleof1to 10. 1 being “poor” and 10 being “excelient”. please rate the following aspects of this program:. 


Easy to use 


User-oriented (e.g.. menus. prompts. clear language) 


Enjoyabie 

Seif-instructive 
Useful (non-game programs) 
Imaginative graphics and sound 


7. Describe any technical errors you found in the user instructions (please give page numbers). 


8. What did you especiaily like about the user instructions? 


9. What revisions or additions would improve these instructions? 


10. On a scale of 1 to 10, 1 representing “poor” and 10 representing “excellent”, how would you rate the user 
instructions and why? 


11. Other comments about the program or user instructions: 


From 


STAMP 


ATARI Program Exchange 
P.O. Box 3705 
Santa Clara. CA 95055 


[seal nerej 


